home *** CD-ROM | disk | FTP | other *** search
/ Workbench Design / WB Collection.iso / workbench werkzeuge / grafik programme / cybershow / cybershow.readme < prev    next >
Text File  |  1996-04-07  |  41KB  |  813 lines

  1. CyberShow Professional Version 5.6 (c) by Helmut Hoffmann 1995
  2. ======================
  3.  
  4. This is an universal shareware picture viewer/slideshow/presentation
  5. program (incl. PhotoCD support, transition effects, zooming ...) and
  6. converter for all Amigas (and Draco!) with OS3.0 and higher which can
  7. display images in windows on the Workbench, on custom screens or public
  8. screens or presentate as slideshow incl. transition effects
  9.  
  10. * in TrueColor/HighColor on CyberGraphX systems (incl. Draco) on such screens
  11. * in reduced color (upto 256 colors) on any screen/Workbench including
  12.   AGA, ECS, OCS and usually WB-Emu graphic board screens (e.g. CybGfx,EGS)
  13.  
  14. It has many special features which make it a flexible, fast and comfortable
  15. multi-purpose tool with flexible format support (over 20 file formats).
  16.  
  17. +-------------------------------------------------------------------+
  18. | By the way:       +-----+-----+-----+-----+-----+-----+-----+---  |
  19. |                   |     |     |     |     |     |     |IFX  |     |
  20. |  Create your own  |  True Color animations...   |with | XiP | ... |
  21. |                   |     |     |     |     |     |     |  Pgs|     |
  22. |                   +-----+-----+-----+-----+-----+-----+-----+---  |
  23. | with ImageFX, XiPaint or Photogenics and my universal loader      |
  24. | modules (FastIFXModules, XiPaintModule, UniversalGIO Modules)     |
  25. | which now all include TrueColor animation savers as well          |
  26. | for the HHsYUVSq animation format... For ImageFX and XiPaint      |
  27. | special ARexx scripts are already included which can automate the |
  28. | creation of TrueColor animations. You can playback the HHsYUVSq   |
  29. | animations e.g. with CyberTVPlayer on your TrueColor Workbench... |
  30. | The fast loading functions of all modules are the same as thoose  |
  31. | in CyberShow Professional (only JPeg is mising).                  |
  32. | Add-on price (to CyberShow or other orders): 8US$ or 10DM each    |
  33. | Special price for registered CyberShow users: 13US$ or 15DM for   |
  34. | one module; additional further modules available at add-on price  |
  35. +-------------------------------------------------------------------+
  36.  
  37. New in V5.6: + Delete function to get rid of unwanted pictures
  38.          + Immediate scrolling during use of scrollbars
  39.          + Random option to display pictures in random order
  40.          + Extended information requester (e.g. number of pictures)
  41. New in V5.5: + Additional menu functions for settings
  42. New in V5.4: + Automatic "downscaling to screensize" option
  43. New in V5.3: + Extended TIF support for "Intel" byte order formats
  44.          + AppWindow (drop your pictures/drawers/disks into the window)
  45. New in V5.2: + Multi-stage cursor scrolling (with Shift and Alt keys)
  46. (see version history for details or earlier versions...)
  47.  
  48. Supported picture file formats for loading:
  49.  
  50. 1) IFF-ILBM (all standard formats 1 to 8Bit, EHB, HAM6, HAM8, 24Bit)
  51. 2) PhotoCD (Base format 768x512 or 512x768 (portrait); linear 24Bit RGB)
  52. 3) JPeg (color and greyscale)
  53. 4) PPM/PGM/PBM (P1&P4 b&w, P5 grey, P6 color)
  54. 5) QRT (also known as dump format by PD raytracers as POV-Ray)
  55. 6) Targa (RLE compr.&uncompr. 1/8/15/16/24/32Bit; incl. interleaved)
  56. 7) PCX (compr.&uncompr. EGA1-4Bit, VGA 8Bit grey/Colormap and 24Bit)
  57. 8) BMP (uncompr. 24Bit RGB,1Bit,4Bit or 8Bit Colormap; RLE compressed 8Bit,1Bit)
  58. 9) TIF (packbit-compr.&uncompr. 24Bit,1-8Bit grey/Color Motorola&Intel formats)
  59. 10) EGS7.x window icons
  60. 11) DEEP (compr.&uncompr. IFF-DEEP 24Bit and 32Bit formats)
  61. 12) YUV (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  62. 13) VLAB raw (color 1:1:1, 2:1:1, 4:1:1 and greyscale)
  63. 14) RGB (IFF-RGB: RGB8 and RGBN compressed; RGB5 uncompressed)
  64. 15) HHsYUVSq sequence format (sequential or random access)
  65. 16) IFF-PBM (DPII) format
  66. 17) ACBM (IFF-ACBM: 1 to 8Bit, EHB, HAM6, HAM8)
  67. 18) FBM (8Bit grey/Colormap and 24Bit)
  68. 19) Sun raster (uncompressed formats for 1Bit, 8Bit grey/ColorMap and 24Bit)
  69. 20) MacPaint (b&w compressed 1Bit format; datafork only)
  70. 21) HHsXRL formats (1-8Bit ColorMap incl. HAM6/8, 8Bit grey, 24Bit RGB compressed)
  71. 22) binary-EPS bitmaps (RGB and CMYK; this function is experimental)
  72. 23) TBCPlus frames&fields
  73.  
  74. and all picture DataType formats (OS3.0 and up) and animation DataType
  75. formats (OS3.1 and up).
  76.  
  77. -> Important! If you have any difficulties viewing certain picture types
  78. -> (e.g. PCX, PhotoCD, DataTypes, JPeg etc.) directly from CD-ROMs (while viewing
  79. -> the same pictures copied to disk works), you have encountered a CD-ROM file
  80. -> system problem. I have heard of difficulties with several third party file
  81. -> systems. I recommend to use only one of the following CD-ROM file systems:
  82. ->    1) Original AmigaDOS OS3.1 CD-ROM file system
  83. ->    2) AmiCD-File System V1.15 or higher (older versions are probably NOT usable)
  84. ->    3) BabelCDROM File System V1.2 or higher
  85. -> see section "Important" below for more details.
  86.  
  87. For animation formats (HHsYUVSq and animation datatypes) the first frame is shown
  88. (for playback of HHsYUVSq animations you can use my freeware program CyberTVPlayer;
  89.  for creation of such animations you can now use my univeral modules for ImageFX,
  90.  XiPaint and Photogenics; see information box above for details...)
  91.  
  92. Please note: The format "GIF" and LZW compressed "TIF" variants are not
  93. internally supported for legal reasons, but due to the DataType support
  94. loading should be possible if you have a suitable DataType (with a fast
  95. GIF or TIF DataType loading is usually still faster than with many other
  96. viewers which directly support theese formats!).
  97.  
  98. Supported picture file formats for saving:
  99.  
  100. 1) IFF-ILBM 24Bit (compressed and uncompressed)
  101. 2) IFF-DEEP 24Bit (uncompressed)
  102.    This format is used e.g. by TVPaint, XiPaint or Photogenics
  103. 3) JPeg (variable compression rates and optimization)
  104. 4) PPM-P6
  105.    This format is used by the PBM image processing software
  106. 5) QRT
  107. 6) Targa 24Bit (compressed and uncompressed)
  108. 7) HHsXRL TC24 format (compressed lossless and lossy)
  109.    This format is esp. designed for raytracing pictures, which should be
  110.    compressed lossless or with nearly invisible losses. Compression is usually
  111.    better than IFF-ILBM or Targa compression.
  112.  
  113. Highlights of CyberShow:
  114.  
  115. + flexible presentation of your pictures in windows or on screens incl.
  116.   slide show function with transition effects, presentation delay etc.
  117.  
  118. + Fast zooming (magnification upto 1:4 and reduction upto 4:1; use + to zoom
  119.   in and - to zoom out; * to go to standard size) and fast scrolling functions
  120.   (cursor keys or scrollbars)
  121.  
  122. + All loading functions (except JPeg: This software is based in part on the work
  123.   of the independent JPeg Group) have been written in Assembler and optimised for
  124.   extremely high speed. Loading will usually be upto 5 times faster than with
  125.   comparable viewers... An exception to this is the JPeg format, which is
  126.   written in C and based on the usual code of the ind. JPeg group.
  127.  
  128. + Automatic preloading: The next picture is loaded while you view the current
  129.   picture; you can now also scroll or zoom the picture or use other functions
  130.   during preloading of the next picture; this reduces waiting time to a minimum
  131.  
  132. + Can view single files, group of files (supporting patterns) and
  133.   even directory trees (automatic search of subdirectories); multiple
  134.   picture arguments can be passed by CLI, Workbench or selected with file
  135.   requester. Images will be shown in alphabetical order (ordered by complete
  136.   path name) or (as option) in random order.
  137.  
  138. + AppWindow function
  139.  
  140. + Optional downscaled loading for faster access and less memory usage
  141.   (selectbale as CLI parameter, WB Tooltype or by menu function)
  142.  
  143. + Can go back to previous images as well
  144.  
  145. + Information window for picture can be opened including name, dimensions,
  146.   file type, file size, file comment and number of frames (for animations)
  147.  
  148. + Fast direct transfer of images to famous image processing and painting
  149.   programs (currently ImageFX, XiPaint and ArtEffect/PicoPainter are supported;
  150.   transfers to other programs could be included if more developers/dealers
  151.   would support me and more programs would have sufficient interfaces)
  152.  
  153. + Save function to convert pictures into some 24Bit file formats (JPeg, IFF, ...)
  154.  
  155. + Delete function to delete pictures you don't like ...
  156.  
  157. Using instructions
  158. ==================
  159.  
  160. Configuration: Usually CyberShow will show the pictures in windows directly on
  161.   the default public screen (usually the Workbench). To make use of other
  162.   screens, private screens or to present the pictures as SlideShow etc,
  163.   you can select options as CLI parameter or by Workbench Tooltypes.
  164.   A screenmode or public screen name can also be specified by the
  165.   environment variable "CyberShowScreen":
  166.  
  167.   a) Custom Screen: If you want a screen to be opened for CyberShow you should
  168.      set an environment variable with the screenmode, e.g.:
  169.      SETENV CyberShowScreen "NTSC:HighRes Interlace"
  170.      You can specify all kinds of screenmodes for Amiga screens, emulation
  171.      screens of graphic boards and TrueColor/HighColor screens for Cybergraphics.
  172.      In any case the screen will be opened with the max. depth which is available
  173.      for that mode. Please note that the screenmode name is case sensitive!
  174.      Take a look at the Prefs/Screenmode program's list of screenmode names
  175.      to see what is available. If you specify an unknown screenmode name or
  176.      the specified screenmode can't be used for some reason the program will
  177.      use the default public screen (after an information requester).
  178.  
  179.      Alternatively you can specify a CLI parameter "Screenmode": e.g.
  180.       CyberShow Screenmode "NTSC:HighRes Interlace"
  181.      This parameter will override the ENV: variable as well as a
  182.      PublicScreen parameter.
  183.      This is also available as tooltype for WB start (e.g.
  184.      Screenmode=NTSC:HighRes).
  185.  
  186.   b) Named Public Screens: If you want to make CyberShow use a non-default
  187.      Public Screen, you can also specify this with the ENV: variable, e.g.:
  188.      SETENV CyberShowScreen "*CoolScreen"
  189.      To distinguish between a screenmode and a public screen name the *
  190.      character has to be specified before the screen name. To find out the
  191.      public screen name of your applications, look into their manuals! The
  192.      screen title of the public screens is often NOT the public screen name.
  193.      If the named public screen can't be used (if it is not found or private)
  194.      then the default public screen is used (after an information requester).
  195.  
  196.      Alternatively you can specify a CLI parameter "PublicScreen": e.g.
  197.       CyberShow PublicScreen "CoolScreen"
  198.      This parameter will override the ENV: variable. Please note that the *
  199.      has not to be specified for the CLI parameter. If you also specify a
  200.      Screenmode parameter, the PublicScreen parameter will be ignored.
  201.      This is also available as tooltype for WB start (e.g.
  202.      PublicScreen=CoolScreen).
  203.  
  204.   To save the screenmode or name specification for automatic use after booting,
  205.   just copy it from ENV: to ENVARC: (or use the WB Tooltype).
  206.   If you want to use the program on the default public screen again, just
  207.   SETENV CyberShowScreen "" or delete the variable from ENV: or from ENVARC:
  208.   for permanent effect (or delete the Tooltype).
  209.  
  210. Important note: The * character is sometimes ignored as input in CLI/shell
  211.     lines (or misinterpreted as #?). This can happen e.g. with
  212.     screenmode names of certain drivers or with public screen name
  213.     specifications; in such a case you should enter the * character
  214.     twice (**), which will then usually lead to one character * as result.
  215.     This can depend on your configuration.
  216.  
  217. Parameters: CyberShow accepts multiple picture/path/pattern and
  218.   configuration parameters both from Workbench and CLI. In addition the
  219.   picture window is an AppWindow in which you can drop picture icons
  220.   or even drawers or disks to view pictures.
  221.  
  222.   a) Workbench usage: To specify pictures, you can multi-select one or several
  223.      pictures or even drawers by holding shift and selecting with the mouse
  224.      before double clicking.
  225.  
  226.      Another method is to make icons for the pictures and specify "CyberShow"
  227.      complete with it's path as default tool.
  228.  
  229.      Other options can be specified as tooltypes in the icon for WB start.
  230.      The options are similair to the CLI options. Take a look at the icon
  231.      to see the available parameters which are enclosed in parentheses to
  232.      make them inactive.
  233.     DefaultPath=path    Provide default path for path/pattern/file
  234.                 requester after startup or for save requester
  235.     Downscale=number    Select downscaling with factor 1:number
  236.                 (number range 1 to 16 supported in increments of 1;
  237.                 some file formats can not be downscaled by all fac-
  238.                 tors; for thoose the next higher factor is used)
  239.     Autoscale        Downscale all pictures to screensize (or smaller)
  240.     NonRecursive        Switch off recursive subdirectory search
  241.     Screenmode=name        Select screenmode name for private screen
  242.                 (Overrides ENV:CyberShowScreen)
  243.     PublicScreen=name    Select named public screen
  244.                 (Overrides ENV:CyberShowScreen)
  245.     Icons            Do not ignore .info files. This is only useful if
  246.                 you have some Icon-Datatype and want to take a look
  247.                 at the icons of files. By default, .info files are
  248.                 now completely ignored. Please note that in
  249.                 addition to this option you might have to remove
  250.                 the ~(#?.info) pattern from the file requester if
  251.                 this is used.
  252.     Request            Show file/path/pattern requester after
  253.                 displaying all files
  254.     PresentWindow        Leave window size unchanged between pictures;
  255.                 window will open at screen size; smaller pictures
  256.                 are shown centered in the window; you can still
  257.                 resize the window manually. On TrueColor/HighColor
  258.                 windows transition effects will be used as default.
  259.                 Use Effects or NoEffects to manually control this.
  260.     SlideShow        Show pictures on screen (no window borders); this
  261.                 works best if you select your own Screenmode. On
  262.                 Workbench or Public screens you will still have
  263.                 a depth arrangement bar on default (you can instead
  264.                 select a backdrop window with another option).
  265.                 As there are no scrollbars, you can only scroll
  266.                 with the cursor keys in this mode. The usual menue
  267.                 functions are still available. On TrueColor/HighColor
  268.                 windows transition effects will be used as default.
  269.                 Use Effects or NoEffects to manually control this.
  270.     BackDrop        Backdrop window for SlideShow on WB or Public Screens
  271.     Black            For small pictures fill unused screen or
  272.                 window areas with the foreground pen (usual
  273.                 black) instead of background (usual grey); in
  274.                 SlideShow mode on private screens black is
  275.                 always used and even specifed as background to
  276.                 make presentations better e.g. for Video recording
  277.     Effects            Select transition effects (default for presentation
  278.                 windows and slideshow on true color screens); use
  279.                 this option to get effects in standard mode or on
  280.                 palette oriented screens (2-256 colors).
  281.     NoEffects        Disable transition effects; if you use this option
  282.                 together with the Effects option, the effects will
  283.                 actually be disabled, but the usual palette locking
  284.                 for 2 to 256 color screens will remain active
  285.     Delay=number        Automatically go to next picture after specified
  286.                 number of seconds; can also be switched on&off by
  287.                 menu (default 8s if switched on without spec. time)
  288.     Loop            Start with first picture again after showing last
  289.                 (useful in conjunction with Delay for automatic
  290.                  presentation at shows etc.)
  291.     IgnoreErrors        Do not show requesters for unreadable files;
  292.                 they will instead be quietly ignored
  293.     PartialFiles        Accept partially corrupt files during loading
  294.                 (at least 50% must be loaded correctly; default
  295.                  is to reject all corrupt files; partial loading
  296.                  is not possible for some formats e.g. Datatypes
  297.                  due to technical reasons; the information
  298.                  requester now contains the % of success, which
  299.                  will be less than 100% for corrupt files)
  300.     SlowJPeg        Use slower (but slightly better?) JPeg loading
  301.     Random            Display pictures in random order
  302.  
  303.   b) CLI usage: You can specify multiple pathes/pictures/patterns in the CLI
  304.      command line, e.g.:
  305.       CyberShow ram:#?.jpg tmp:#?.iff "CD1:Photo_CD/Images"
  306.      Picture parameters can be included in " for better compatibility.
  307.      This should work with directory utilites as well (I checked it with DirOpus
  308.      4.12A+: E.g. specify CyberShow {F} as DOS command for your CyberShow button;
  309.      please note that DirOpus will call CyberShow multiple times if you select
  310.      too many files for the CLI command length limit; this can have unpleasant
  311.      effects if you want to view many pictures as slideshow from DirOpus).
  312.      There are many other parameters available as command line options, which are
  313.      usually identical to the Workbench ToolTypes. Type CyberShow ? to get a list
  314.      of parameters. Here are the additional parameters (incl. abbreviations):
  315.     DS=Downscale (number)
  316.     AS=Autoscale
  317.     NR=NonRecursive
  318.     SM=Screenmode (name)
  319.     PS=PublicScreen (name)
  320.     Icons
  321.     Request
  322.     PW=PresentWindow
  323.     SL=SlideShow
  324.     BD=BackDrop
  325.     Black
  326.     Effects
  327.     NoEffects
  328.     Delay (number)
  329.     Loop
  330.     IE=IgnoreErrors
  331.     PF=PartialFiles
  332.     SlowJPeg
  333.     Random
  334.      -> see WB tooltypes above for detailed explanation
  335.  
  336. If you just start CyberShow without any picture parameters, a file/path/pattern
  337. requester appears. With this you can specify a directory (path) with an optional
  338. pattern or select one or multiple pictures (by holding shift during the selection).
  339. You can select a new file/path/pattern by using the "New Directory" menu entry
  340. at a later time (it will be shown automatically after displaying all files
  341. if you select the Request option) or by dropping icons of pictures, drawers
  342. or even disks into the CyberShow window which is now an AppWindow.
  343.  
  344. In any case subdirectories will be searched automatically if you don't restrict
  345. searching by a pattern to one directory or use the NonRecursive option.
  346.  
  347. Default is to load pictures in full size. With the "Scaled-Loading" menue
  348. or Downscale option you can select to load all pictures in reduced size.
  349. For many file formats this downscaled loading will be significantly
  350. faster. Please note that the pictures will be in small form in memory, thus
  351. save or transfer operations will save or transfer the images in small form.
  352. This is different from the zooming functions. If you load a picture
  353. in normal size you can zoom out to get it in reduced size as well, but
  354. then the image remains in original resolution in memory.
  355. Automatic downscaling to screen size is also available as option or
  356. by menu. This will lead to a downscaled loading which reduces all pictures
  357. to the screen size or a smaller size, if that is not possible.
  358.  
  359. To show pictures as slideshow instead of windows, it is best to specify
  360. a screenmode as well: E.g.
  361.   cybershow #?.jpg SlideShow ScreenMode "PICCOLOSD64:800x600x16M"
  362. You can also use the slideshow as backdrop e.g. on the WB screen.
  363. SlideShows and PresentWindow presentations will by default use transition
  364. effects on TrueColor/HighColor screens. You can switch them off with
  365. the NoEffects option or select them with Effects for palette oriented
  366. screens or standard viewing (automatically resized window). Please note
  367. that effects on palette oriented screens can be quite slow (due to
  368. this fact some effects are only available on TrueColor/HighColor
  369. screens; while zooming is active, some effects are also disabled
  370. for speed reasons) and that the palette will be locked for all
  371. pictures. This can lead to reduced displaying quality if you have
  372. many pictures with different colors. On TrueColor/HighColor screens such
  373. problems can not occur. For automatic presentations you can specify
  374. a delay time after which the next picture is selected automatically and
  375. a loop function for endless presentations. You still have full manual
  376. control with Menu functions or keys (use Esc or Quit to exit). The
  377. loop function will only be active if at least 2 pictures are available.
  378. The random option can be used to display pictures in random order.
  379.  
  380. To advance to the next picture use the "Next Picture" menu entry
  381. (Shortcut Amiga N), press the space bar or press the close button of the
  382. picture window (the next picture will be selected automatically if you
  383. have specified a number of seconds as a delay time). During displaying the
  384. next picture will already be loaded. You can now scroll or resize the window
  385. or select another function while the next picture is preloaded (due to
  386. technical restrictions of some file formats this is partially not available
  387. if pictures are not stored line by line, e.g. FBM24, ACBM, DataTypes, vertical
  388. PCD images, YUV, VLB, HHsYUVSq; during the color conversion phase you can
  389. still scroll and this phase is often longer than the loading time unless
  390. you load from floppy disk).
  391.  
  392. Scrolling: Scrolling can be performed with cursor keys or the scroll bars
  393.  (scroll bars are not available in slideshow mode). You can select
  394.  between different cursor scrolling speeds (use cursor keys with Shift
  395.  for fine scrolling, ALT to scroll upto the border or without other key
  396.  to scroll for one third of the window).
  397.  
  398. Zooming: Since V5.0 you can zoom in and out to magnify or reduce the
  399.  picture; to zoom in press the + key (max. magnification 1:4); to zoom
  400.  out press the - key (max. reduction 4:1); to go back to standard viewing
  401.  (1:1) press the * key. Zooming functions are also available as menu
  402.  entries. Please note that reduced viewing is different from downscaled
  403.  loading; if you load a picture downscaled, it is kept in memory
  404.  in reduced size and transfers or saves will be in reduced size
  405.  as well. If you just zoom out to reduce a picture, it remains
  406.  in memory in it's full resolution. The zoom stage will be kept even
  407.  if you change to the next picture.
  408.  
  409. You can also go back to previous pictures with the "Previous Picture"
  410. menu entry (Shortcut Amiga P) or by pressing the backspace key.
  411.  
  412. If you try to select the next picture (or previous picture) before
  413. automatic preloading has finished, the window title will inform you about
  414. the already loaded part of the picture (in percent).
  415.  
  416. For the currently displayed picture you can get an information requester
  417. by selecting the "Picture Info" menu item (Shortcut Amiga I). It includes
  418. the name, dimensions (original and loaded), file format, file size, file
  419. comment and number of frames (for animations). The file format string often
  420. includes the color depths or other variation informations as well. For
  421. pictures loaded with any DataType, the file type begins with "DTxx" with
  422. xx being the color depth. For animations loaded with DataType the file type
  423. begins with "DHxx". This is followed by the recognition string of the
  424. DataType, if available. For partially loaded files (use option PartialFiles)
  425. the information requester contains in percent the part which is loaded
  426. correctly. In addition the picture number and total number of files are
  427. displayed.
  428.  
  429. You can quit the program with the "Quit" menu item or by pressing the Esc
  430. key in the picture window (or screen), by pressing Ctrl-C in the CLI or
  431. sending a Ctrl-C signal to the task.
  432.  
  433. The "About" menu function gives an information requester (which includes
  434. the personal registration information if you are a registered user with
  435. a correctly installed keyfile).
  436.  
  437. Fast direct transfer and saving/conversion (not available in demo version):
  438.  
  439. You can directly transfer the image in full 24Bit quality very fast to
  440. important image processing and painting programs (see transfer menu).
  441. Currently supported applications: ImageFX, XiPaint and ArtEffect/PicoPainter
  442. For ArtEffect/PicoPainter you can transfer the image into a picture
  443. project window or into a brush.
  444.  
  445. Please note that pictures will always be transferred in their loaded
  446. size. If you have selected the downscaled loading, the pictures will
  447. be transferred in small form.
  448.  
  449. The same restrictions apply to the save functions which can be used to
  450. convert the currently loaded image into one of several formats (see
  451. above for list of supported save formats). All pictures are saved as
  452. 24Bit images. This is not dependent on the screenmode. The size which
  453. has been used for loading will be the size in which it is saved. For
  454. JPeg saving you can select the quality between 50% and 95% in 5% steps
  455. with a sub menu and optional an additional optimization (needs extra
  456. memory during saving but can lead to slightly smaller files without
  457. additional loss).
  458.  
  459. Registered users can also delete the file of the currently visible
  460. picture (after confirmation requester); the picture will remain in
  461. loaded form in memory and can thus still be saved afterwards.
  462.  
  463. Important: Please read the following
  464. ------------------------------------
  465.  
  466. -> Problems with loading specific file formats? <-
  467.  
  468. If you have difficulties viewing a picture in one of the supported
  469. file formats (or DataTypes) and you are sure that you have enough
  470. memory left, check the following:
  471.  
  472. a) File systems: Some PD/ShareWare/Commercial add-on or replacement
  473.    file systems (esp. CD-ROM file systems!) are buggy (e.g. they do
  474.    not support some rarely used DOS functions properly). Try to copy
  475.    the picture to a standard device (e.g. RAM:) and to view it from
  476.    there. If this works, you know that your specific file system is
  477.    buggy. I found the following file systems to be usable:
  478.    1) Original AmigaDOS OS3.1 CD-ROM file system
  479.    2) AmiCD-File System V1.15 or higher (older versions are probably NOT usable)
  480.    I also heard that the following works without problems:
  481.    3) BabelCDROM FileSystem V1.2 or higher
  482.    I recommend to only use one of theese CD-ROM file systems.
  483.    Several users e.g. reported problems with "AsimCD-Filesystem 3.0";
  484.    so this seems to be an unsuitable Filesystem (maybe the newer 3.4
  485.    version supports all necessary functions). Typical unimplemented
  486.    or wrong functions in filesystems are: NameFromFH (needed for Datatype
  487.    access) and ExamineFH (needed for several formats, e.g. PCX-VGA).
  488.  
  489. b) DataTypes: Some DataTypes are instable and can crash on certain
  490.    pictures with odd dimensions or incomplete pictures. I have no
  491.    influence on this. If you have difficulties with certain DataTypes,
  492.    look out for newer versions.
  493.  
  494. Requirements
  495. ============
  496.  
  497. Any Amiga (or Draco!) with
  498.  
  499. + OS3.0 or higher
  500. + some memory (about 4MByte Fast-RAM should be enough for normal use)
  501.  
  502. For displaying in TrueColor/HighColor quality you also need
  503.  
  504. + cybergraphics.library V40 or higher and a suitable graphic board
  505.   (Cybergraphics is a Workbench emulation/True color software extension
  506.    which is usable in conjunction with several graphic boards as the
  507.    Cybervision, Piccolo, SD64, Picasso, Retina-BLTZ3, Spectrum, Domino.
  508.    It is Copyright by Thomas Sontowski and Frank Mariak.)
  509.  
  510. Please note: The Draco computer already contains a built in graphic
  511.  board, so that you can use CyberShow in TrueColor without additional hardware.
  512.  
  513. Shareware modalities
  514. ====================
  515.  
  516. The unregistered demo version of CyberShow has an important restriction:
  517.  
  518. All pictures will be shown in greyscale only in the demo version!!!
  519.  
  520. Anyway, I have designed the loading functions so that the speed is the
  521. same as with color loading so that you can check the real speed of my
  522. fast loading functions, but please note: on screens with less than
  523. 15Bit color depths the displaying speed of the greyscale pictures could
  524. be higher than that of color pictures due to the fact that the color pen
  525. allocation is different. I have no influence on this; to see the real
  526. speed, try it on HiColor/TrueColor screens (if you have Cybergraphics),
  527. as no color pens are needed and it makes no difference if a greyscale
  528. or true color image is displayed. If you want to see how the color
  529. allocation works with 2 to 256 colors, take a look at CyberTVPlayer,
  530. my freeware TrueColor animation player for HHsYUVSq animations (which
  531. you can now create with ImageFX, XiPaint and Photogenics; see above).
  532. CyberTVPlayer uses the same color reducing functions as CyberShow.
  533.  
  534. Some other functions are also not available in the demo version (e.g.
  535. direct transfer functions, delete, save functions, AutoScale and AppWindow).
  536.  
  537. Registration for CyberShow Professional:
  538.  
  539.    Shareware fee 30DM (in europe) or 25US$ (outside europe); other
  540.    currencies possible (see registration form).
  541.    Together with CyberShow you can order fast loader/saver modules for
  542.    several programs the add-on price of 10DM or 8US$ each.
  543.  
  544. To register send the filled in and signed registration form (included
  545. in this archive) to my address together with the money as banknotes,
  546. a cheque or international postal money order:
  547.  
  548. My address:             Helmut Hoffmann
  549.             Rubensstrasse 4
  550.             D-41063 Moenchengladbach
  551.  
  552.             Germany
  553.  
  554. Users in germany can also transfer money to my account (No bank transfers
  555. from outside germany!!).
  556.  
  557. You can currently contact me by EMail (no registrations by EMail!):
  558.  
  559.         hhoff@pool.informatik.rwth-aachen.de
  560.  
  561. After registration you will receive a keyfile and the latest version of
  562. this program. The keyfile will enable you to use future demo versions of
  563. this program as full version. The processing of your order can take
  564. some time. Usually it will be very fast (only a few days), but under raw
  565. circumstances it could take some weeks.
  566.  
  567. Registered users might get another advantage: If I decide to port my
  568. picture management software EGSPhotoAlbum for Cybergraphics and standard
  569. Amigas, registered CyberShow users can register for a lower price.
  570. The fast loading functions of CyberShow are the same as thoose in
  571. EGSPhotoAlbum Professional 5.x.
  572.  
  573. Where to find the latest versions
  574. =================================
  575.  
  576. New versions become usually available at least at the following places:
  577.  
  578. 1) FTP and BBSs
  579.  
  580. Aminet sites and mirrors or mirrowing BBSs
  581.  
  582. 2) CD-ROMs
  583.  
  584. New versions will usually be available on Aminet CDs (currently appearing
  585. every two months), Fresh Fish CDs or the ADX-CD.
  586.  
  587. Version history
  588. ===============
  589.  
  590. 1.0 (14th june 95): Initial release (supporting 21 file formats and DataTypes)
  591. 2.0 (19th june 95): Added menu for picture windows offering Quit, About, SaveAs,
  592.             Picture Info, Next/Previous Picture, Transfer, Downscale
  593.             Added fast direct transfer functions to ImageFX, XiPaint
  594.             and ArtEffect/PicoPainter
  595.             Added saving functions (7 formats) for picture conversions
  596.             Added function to go back to previous pictures
  597.             Added scrollbars for comfortable scrolling
  598.             Implemented faster scrolling methods
  599.             Functions like scrolling/resizing now already usable
  600.             during the next picture is loaded
  601.             Window position will now be left unchanged for newly
  602.             opened windows if possible; the scroll position will
  603.             be left unchanged between pictures of identical size
  604.             Information requesters for unreadable pictures/problems
  605.             Preloading is suppressed if not enough memory is available
  606.             Support of downscaled loading (1:1, 2:1, 4:1, 8:1)
  607. 3.0 (30th june 95): New reduced color output function which is available with
  608.             OS3.0 and not only with OS3.1; drawing speed increased
  609.             for Amiga screens and certain emulations
  610.             Support of separate screen with screenmode specified in
  611.             ENV:CyberShowScreen
  612.             Added menu function to select a new directory and/or pattern
  613.             Changed menu colors for OS3.x look
  614.             Changed file requester for saving to a save requester with
  615.             picture file name as default for save name as well
  616. 3.1 (7th july 95):  Support of use of named foreign public screen with name
  617.             specified (with a leading *) in ENV:CyberShowScreen
  618.             Information requester if screenmode or public screen can't be
  619.             found or own screen can't be opened
  620.             Fixed bug which could lead to crashes if files couldn't be
  621.             opened after they have been stored in the internal list;
  622.             now you can choose to try the next picture or quit the
  623.             program in case of any difficulties
  624.             Fixed bug which could lead to problems if window couldn't be opened
  625.             Correction of Sun raster 24Bit loading (wrong colors and
  626.             problems with odd sized images)
  627. 3.2 (21st july 95): Support for RLE compressed 8Bit and 1Bit BMP files
  628.             Bug fix for loading function which could lead to crashes if
  629.             certain non-picture files where detected as a picture
  630. 3.3 (24th july 95): Enhanced CLI parameter control incl. multiple picture arguments
  631.             and new parameters
  632.             Added Workbench parameter support for pictures and even drawers
  633.             Added muliple-file-selection support for file/path requester
  634.             Extended information window (now incl. file size, file comment)
  635.             Now ignoring icons (.info files) on default
  636.             Next/previous picture now also selectable with space/backspace keys
  637. 3.4 (27th july 95): Now configurable by Tooltypes for start from WB
  638.             Introduction of "DefaultPath" Tooltype to specify a directory
  639.             as default for the file requester by WB start
  640.             New option "Request" for automatic requesting of new
  641.             path/pattern/files after displaying is finished
  642.             Introduction of Progress indicator which appears in the
  643.             window title if Next/Previous picture is selected before
  644.             the picture is available (preloaded)
  645.             Higher file requester window for easier multi-selection
  646. 4.0 (1st aug. 95):  Introduction of SlideShow and Presentation window features:
  647.             in standard mode window will now be resized instead of
  648.             being closed and opened again if picture size changes;
  649.             in presentation mode window size will be unchanged
  650.             unless changed by the user; in slideshow mode a
  651.             borderless (optional: backdrop) displaying will be
  652.             used for pure presentations, esp. on private screens
  653.             Introduction of transition effects for SlideShows or
  654.             presentation mode
  655.             Changed min. window size and set useful small alternate
  656.             window size on default for zoom gadget
  657.             Introduction of IgnoreError option to skip unreadable
  658.             files quietly (useful if you e.g. have many non-picture
  659.             files like .readmes on a CD you want to scan for
  660.             pictures without getting lots of errors)
  661. 4.0a (2nd aug. 95): Bug fixes for window titles (could lead to corrupt titles)
  662. 4.1 (5th aug. 95):  Changed TIF loader for better compatibility with certain pics
  663.             Extended Targa loader by 15Bit and 16Bit HiColor loading
  664. 4.1a (7th aug. 95): Corrected XiPaint transfer problems (appeared in V3.3)
  665. 4.2 (15th aug. 95): Added 5 new transition effects for slideshow/presentations
  666.             Changed window redraw for scrolling/resizing to be done
  667.             without effects in presentation windows
  668. 4.3 (20th aug. 95): Introduction of automatic advancing to next picture (delay
  669.             option) after specified number of seconds
  670.             Introduction of loop mode (for endless presentations)
  671.             Screen font changed to other font instead system text font
  672. 5.0 (30th aug. 95): Introduction of fast zooming functions for magnified or
  673.             reduced viewing (1:4 upto 4:1)
  674.             Support for new file formats: binary-EPS bitmaps (RGB,CMYK)
  675.             and TBCPlus frames
  676.             Fixed lockup-bug which occured if picture had to be reloaded
  677.             for new downscaling factor but was not accessible anymore
  678.             Added (partial) german documentation file
  679. 5.1 (05th sep. 95): Changed standard viewing mode to support effects as well
  680.             in automatically resized windows
  681.             Changed JPeg loading to use faster decoding method
  682.             (old slower method still available as option)
  683.             Added support for optimized JPeg saving (selectable by menu)
  684.             Added support for partial file loading (corrupt files) as
  685.             option & extended file info requester with status field
  686.             Extended file format information for Datatype loaded pictures
  687.             or animations (includes now DT specific ID if possible)
  688. 5.2 (27th sep. 95): Added multi-stage cursor scrolling functions. Use cursor
  689.             keys without qualifier to scroll as usual (1/3rd of the
  690.             window). Use them with Shift for smooth scrolling and
  691.             with Alt to scroll in one go upto the border.
  692. 5.3 (9th oct. 95):  Extended TIF loader to support "Intel" byte order files and
  693.             more image variants
  694.             Added zooming functions into menu
  695.             AppWindow function for picture window: drop picture icons,
  696.             drawers or whole disks into the window for displaying
  697.             File requester now uses picture path as default
  698. 5.4 (27th oct. 95): Automatic "downscaling to screensize" option
  699.             Fixed slideshow window title bug
  700.             Fixed bugs leading to unprecise automatic delays
  701.             Adapted scrollbars to respect unusual sized size gadgets
  702. 5.5 (15th nov. 95): Improved handling of unreadable pictures if "IgnoreErrors"
  703.             is used; now the next loadable picture is preloaded
  704.             Added menu functions for delay,loop,effects,ignore,partial
  705.             Fixed bug for "PartialFile" loading of IFF-ILBM masks
  706.             Extended IFF loader to accept 0-sized chunks
  707. 5.6 (7th dec. 95):  Delete function to delete current picture file
  708.             "Random" option to display pictures in random order
  709.             Immediate scrolling during use of scrollbars
  710.             Faster smooth cursor scrolling (w. Shift) while zoomed in
  711.             Extended PicInfo requester (loaded size; picture numbers)
  712.             Fixed bug which lead to endless loop if loop mode was
  713.             selected and no pictures where left to display
  714.  
  715. Special Thanks
  716. ==============
  717.  
  718. My special thanks go to:
  719.  
  720.  Kermit Woodall from NOVA-Design for providing me with ImageFX.
  721.  Thomas Dorn for providing me with XiPaint.
  722.  Almathera for providing me with Photogenics.
  723.  Alexander Pratsch for providing me with ArtEffect.
  724.  Without this support the fast direct transfer functions or loader modules
  725.   would probably have been impossible.
  726.  Thomas Sontowski and Frank Mariak for making the TrueColor/HighColor
  727.   Workbench possible.
  728.  The "Independent JPEG Group" for providing the portable C source code
  729.   for JPeg compression/decompression. The JPeg functions are based on
  730.   this code (This software is based in part on the work of the independent
  731.   JPeg Group).
  732.  and to all registered users of CyberShow, esp. thoose who reported bugs
  733.   or made suggestions...
  734.  
  735. Hard- and Software used for developing
  736. ======================================
  737.  
  738. This program is written in pure Assembler (using the german assembler
  739. O.M.A.). Only the lowlevel JPeg functions have been implemented
  740. in C (based on the portable C source of the Independent JPeg Group)
  741. and compiled with the german MaxonC++ 3.x system.
  742.  
  743. My development system is:
  744.  
  745. Amiga 3000/030/25MHz / 18 Megabytes RAM / OS3.1 (incl. OS3.1 CD file system)
  746.  
  747. 4MByte Piccolo SD64 (64Bit) graphics board (running in Zorro III-mode).
  748.  
  749. This program was tested with enforcer and mungwall running.
  750. This program was also tested on a Draco computer.
  751.  
  752. Disclaimer
  753. ==========
  754.  
  755. This software (program and documentation) is provided "as is" and
  756. comes with no warranty, either expressed or implied.
  757. The author is in no way responsible for any damage or loss that may
  758. occur due to direct or indirect usage of this software. You use
  759. this software entirely at your own risk.
  760.  
  761. Copyright
  762. =========
  763.  
  764. This software (program and documentation) is copyright by
  765.  
  766.                         Helmut Hoffmann
  767.             Rubensstrasse 4
  768.             D-41063 Mönchengladbach
  769.  
  770.             Germany
  771.  
  772. The demo version may be freely distributed and used as
  773. long as the following conditions are met:
  774.  
  775. 1) All files have to be kept together
  776.  
  777. 2) No file may be modified or crunched/packed.
  778.  
  779.    The only official way to distribute this demo packed is the
  780.    original .lha archive.
  781.  
  782.    The program may not be disassembled or analysed. The limitations
  783.    integrated in the demo version may under no circumstance be removed
  784.    or bypassed.
  785.  
  786. 3) Distributors may only charge for the duplication process (including media)
  787.    and not for the software. Theese charges may not exceed the following
  788.    limits: a) Demo on a PD-disk: 8$ (US-dollar) including
  789.               postage&packing (in Germany: 12DM)
  790.        b) Demo on a PD-CD-ROM: 50$ (US-dollar) including
  791.               postage&packing (in Germany: 75DM)
  792.        c) Demo on a BBS/Mailbox/ftp-site or other electronically
  793.               callable system: Maximum charge 4$ (US-dollar) (in Germany: 6DM)
  794.               for downloading
  795.    Anyway, it must be made explictly clear to the buyer, that he does not
  796.    pay for the program (demo) itself but only for the duplication service.
  797.  
  798. 4) It is not allowed to distribute the demo with any commercial product
  799.    without a written permission by me. One exception is the distribution of
  800.    the demo version with products not exceeding the above price limits (e.g.
  801.    a cover-disk magazine for 8$ or less).
  802.  
  803.    The following companies have my explicit permission to distribute the
  804.    demo with their products: Almathera, NOVA Design, Ingenieurbüro Helfrich.
  805.  
  806.    If you want to distribute the demo with your commercial product
  807.    (hardware or software) write to me for details.
  808.  
  809. 5) The registered version (the keyfile) may not be redistributed. It may only
  810.    run on one machine per registration. It is allowed to make a backup copy
  811.    of the original disk.
  812.  
  813.